Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/docs/content/docs/ai-resources/index.mdx`:
- Around line 15-34: Fix sibling-page links in
packages/docs/content/docs/ai-resources/index.mdx (lines 15-34) by removing the
redundant ai-resources/ prefix from all three list links, the Callout link, and
all three Card hrefs. Apply the same link corrections to the equivalent links in
packages/docs/content/docs/ai-resources/index.zh.mdx (lines 15-34), using bare
./xxx paths.
- Around line 15-21: Update all relative links in the ai-resources index page,
including the three list items, the Callout link, and the three Card hrefs, to
remove the redundant ai-resources/ path segment and use ./set-up-ai-tools,
./verify-and-troubleshoot, and ./prompting-best-practices.

In `@packages/docs/content/docs/ai-resources/index.zh.mdx`:
- Around line 15-21: Update the links in the Chinese AI resources index,
including the corresponding Callout link, to remove the duplicated
`ai-resources/` path segment. Preserve each link’s target page and use paths
relative to the index file’s location.

In `@packages/examples/src/issueUdtSus.ts`:
- Around line 268-275: Move the Playground invocation of issueXudtWithSUS and
its result logging out of module-level execution into a separately called
function or documentation-only snippet. Ensure importing the module does not
initiate signing or broadcasting, while preserving the existing invocation
behavior when explicitly called.
- Around line 70-75: Validate all mint inputs before any broadcast: update the
parameter validation near the issueUdtSus flow to require integer decimals in
0..255, precompute metadata, and validate supply as a non-negative uint128
before createSealCell or Step 1. Apply the same integer-decimal validation and
preflight metadata/supply checks in packages/examples/src/issueUdtSus.ts lines
70-75 and 125-147, and mirror both changes in skills/ckb-ccc-udt/SKILL.md lines
91-96 and 146-168.
- Around line 32-34: Make totalSupply use one explicit unit convention across
IssueXudtSusParams and its serialization path at issueUdtSus, either narrowing
the accepted representation or documenting bigint as already scaled while
preserving consistent ccc.fixedPointFrom behavior. Update
packages/examples/src/issueUdtSus.ts lines 32-34 and 208, and align
skills/ckb-ccc-udt/SKILL.md lines 53-55 and 360-362 so the checklist and
documentation state the same contract.

In `@skills/ckb-ccc-fundamentals/SKILL.md`:
- Line 177: Tag every affected fenced documentation block to satisfy
markdownlint MD040: use http for request examples at
skills/ckb-ccc-fundamentals/SKILL.md lines 177, 187, and 199 and
skills/ckb-ccc-examples-finder/SKILL.md lines 22-24; use text for URL-only
examples at skills/ckb-ccc-fundamentals/SKILL.md lines 221 and 227.

In `@skills/ckb-ccc-playground/SKILL.md`:
- Around line 94-97: Update the `?src=` documentation to explicitly warn that
fetched raw URLs contain untrusted executable code and run with the Playground’s
pre-connected signer. Recommend inspecting the source and pinning it to an
immutable Git commit before selecting Run, particularly when using mainnet,
while preserving the existing link-longevity guidance.

In `@skills/ckb-ccc-signer-setup/SKILL.md`:
- Line 68: Update the Verify step in SKILL.md to use an actual confirmation
wait, replacing the single getTransaction(txHash) polling description with await
client.waitTransaction(txHash, 1), or document an explicit retry loop that
checks confirmation status.
- Around line 63-76: Update the signer setup example around CKB_PRIVATE_KEY to
explicitly validate that process.env.CKB_PRIVATE_KEY is set before constructing
SignerCkbPrivateKey. Fail immediately with a clear error when it is missing,
then pass the validated value to the constructor instead of relying on the
non-null assertion.

In `@skills/ckb-ccc-spore/SKILL.md`:
- Around line 165-183: Make the Spore transfer example self-contained by adding
the required ccc import and showing initialization or definition of signer and
recipientAddr before they are used. Keep the existing createSpore and
transferSpore flow intact, and ensure ccc.Address.fromString receives the
initialized signer.client.
- Around line 60-68: Update both cluster-creation examples to capture the
transaction hash returned by signer.sendTransaction and await
signer.client.waitTransaction before invoking ccc.spore.createSpore. Preserve
the existing fee completion and minting flow, ensuring cluster indexing
completes before createSpore resolves the cluster via assertCluster.

In `@skills/ckb-ccc-transactions/SKILL.md`:
- Around line 70-72: The capacity guidance in the SKILL.md gotcha row and
checklist must describe output-dependent occupied capacity rather than a fixed
61 CKB minimum. Update both references to state that occupied capacity is
calculated from each output’s lock, type script, and data, while retaining the
instruction to use CCC helpers instead of manual calculation.

---

Nitpick comments:
In `@skills/ckb-ccc-spore/SKILL.md`:
- Around line 42-44: Update generateSimpleDNA to use a cryptographically secure
random number generator supported by the target runtime instead of
Math.random(), while preserving the requested hexadecimal DNA length. If this
helper is intentionally demo-only and predictable output is acceptable, document
that limitation directly with the helper.